home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / testreq.zip / TESTREQ.DOC next >
Text File  |  1992-03-13  |  7KB  |  155 lines
  1.  
  2.                             testreq v0.4
  3.  
  4. Testreq has been modified once again in the area of FD system filenames.
  5.  
  6. Testreq will first look for SETUP.FD and if not found it will then look
  7. for the older FD.SYS config file.
  8.  
  9. Please note that if Testreq finds SETUP.FD it will then expect
  10. request.FD and if FD.SYS is used, request.SYS is expected.
  11.  
  12. You may merely copy request.fd to request.sys if need be.
  13.  
  14.  
  15. ------------------------------------------------------------------------
  16.  
  17.                             testreq v0.3
  18.  
  19. Testreq has been updated to work with FrontDoor 2.01.  The ONLY change
  20. has been to accomodate the change in FD filenames from FD.SYS =>
  21. FDSETUP.FD and REQUEST.SYS => REQUEST.FD.
  22.  
  23. Any quirks, mites, bugs, etc., which may have existed in v0.2
  24. still exist in v0.3.
  25. -----------------------------------------------------------------------
  26.  
  27.                            testreq v0.2
  28.  
  29. after a recent bout of BrainDamage<tm> and some embarrasing moments
  30. by royally screwing up a magic filename setup for my beta testers, I
  31. decided to write this little program.  It's very green and was written
  32. in a few hours, so don't expect too much.  I haven't tried REAL hard to
  33. make it break, so you may find that it will.  If so, I'd like to hear
  34. about it.
  35.  
  36. First the warnings:  ummm... none that I can think of.  TestReq doesn't
  37. WRITE to anything but your screen (and it doesn't even do that
  38. 'directly') so it shouldn't be able to really hurt anything.  Still, I
  39. guarantee nothing.  TestReq may or may not be accurate depending on how
  40. it is used and it may or may not work at all!
  41.  
  42. How it is _supposed_ to work is this... run Testreq and supply either a
  43. filename (wildcards are ok) or a magic name that you _think_ should
  44. result in a file being sent when such a request comes in.  Don't use a
  45. path since an incoming request wouldn't have a path on it.
  46.  
  47. If in fact the file is locatable by FD, TestReq should be able to find
  48. it too... at least that's the plan :-)  TestReq will then display ALL
  49. matches that FD would find for that particular request.  If you were to
  50. type...
  51.  
  52.  TestReq *.zip
  53.  
  54. it should list all eight zillion files in your requestable directories.
  55.  
  56. If the file would not be sent by FD, TestReq won't find it either, with
  57. one exception, password protected directories or filenames.
  58.  
  59. TestReq does not skip the file or directory if it is password protected.
  60. Instead, TestReq will display the path\filename and next to it display
  61. the password in the form '!password'.  That way, you'll know that when
  62. someone requests the filename you provided to TestReq, they're gonna
  63. need to supply the displayed password too.  The '!' character is
  64. prepended to the password just to make it stand out a bit and of course
  65. is not part of the password.
  66.  
  67. TestReq will first look for the environmental variable 'FD'.   If found,
  68. it'll follow this path to find FD.SYS.  If not found it will look in the
  69. current directory for FD.SYS.  If FD.SYS ain't there, Testreq ends.
  70.  
  71. When FD.SYS is found, Testreq then looks for REQUEST.SYS in what FD.SYS
  72. says is the system directory.  It's ok if REQUEST.SYS is zero bytes long
  73. (as it might be if you had password protected files at one time then
  74. deleted all files & passwords) or non-existant. If it's zero bytes or
  75. not there it just won't be checked for passwords.
  76.  
  77. FD.SYS also provides the path\filename of your ALIAS list and your
  78. requestable directories list.
  79.  
  80. These items are found in SETUP => Mailer => File Requests.  The second
  81. item in the 'File Requests' screen is labeled 'List'.  This is what I
  82. will (from now on) call your OKFILES list.  The third item on this
  83. screen is labeled ALIAS and is your list of ALIAS or MAGIC filenames.
  84.  
  85.  
  86.         *** NOTE *** CAUTION *** WARNING *** LOOKYHERE ***
  87.  
  88. TestReq does NOT assume anything with the OKFILES and ALIAS list.  If
  89. you have defined these filenames without a path, TestReq assumes they
  90. are in the current directory.
  91.  
  92. FD seems to work the same way.  I run FD from my RemoteAccess directory.
  93. If I don't define the full path to my OKFILES and ALIAS list, FD
  94. generates an error trying to open those files when a request comes in.
  95.  
  96. It seems that there are quite a few possibilites when it comes to how
  97. files are password protected.  At this point in time I'm still not sure
  98. what, as SETUP calls it, a 'Unique portion thereof' is for the
  99. Filename\Path field in the Setup => Manager => Requests screen.
  100.  
  101. Since I don't have a second mailer and computer with which to make
  102. multiple tests, I have to wait for some feedback on what others are
  103. using successfully and how TestReq reacts to 'odd' setups.
  104.  
  105. In FD's SETUP Filename\path field, TestReq expects to find:
  106.  
  107.  1) a full path. i.e. Drive:path WITH a trailing backslash.  This is how
  108.     _I_ would password protect an entire directory, and that seems to
  109.     work.
  110.  
  111. 2) Anything that doesn't have a trailing backslash is considered to be
  112.    a filename or a magic name.
  113.  
  114. In other words, if you have an entry like this in the request manager...
  115.  
  116.  
  117.  Filename or path                             Password
  118. ----------------------------------------------------------------------
  119. C:\Files\Newfiles                           YourPassword
  120.  
  121.  
  122. TestReq will consider "NewFiles" to be a filename or Magic name rather
  123. than a subdirectory.
  124.  
  125. And of course TestReq could care less about time of day you may have
  126. defined as "no requests", events that don't allow requests and/or what
  127. types of systems (listed, unlisted, etc.) may request.  That wouldn't
  128. make much sense since you might run TestReq during an event that doesn't
  129. allow requests, and yet a request may come in under another event, or a
  130. request might come in... well, the possibilities just boggle the mind!
  131.  
  132. The best way to get the feel of how TestReq works is to just go ahead
  133. and use it.  Try 'TestReq Files' and see if it reports the correct file
  134. that is sent when someone requests FILES.  Try it with a file you know
  135. to be password protected or try a magic name you have set up.
  136.  
  137. One item that is known NOT to work is a magicname with multiple files.
  138. In otherwords, if you defined a magicname like this:
  139.  
  140. RA c:\files\ra_00?.zip c:\files\ra_upd.zip
  141.  
  142. FrontDoor would send BOTH files when receiving "RA" as a magic name
  143. request.  TestReq presently only reports the first filename.  This is
  144. due to be fixed in a future version.
  145.  
  146. Any feedback is appreciated and bug fixes, enhancements will be taken
  147. into consideration.
  148.  
  149. enjoy,
  150.  
  151. Mike Janke, 1:135/4
  152. Data (305)271-2146
  153.  
  154.  
  155.